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Global Update 


Overview 


The Global Update function is available in both the Station Configuration and 
the CPND configuration dialog box. It lets you change common data values 
in each of selected items in the main application window (Station list or 
CPND list) either directly or through a confirmation option. 


The Global Update procedure involves the following steps: 


1 Select those list items that you wish to update. The Select feature may be 
used to select stations based on specific criteria. 


2 Select a field for update. 


3 Define the update or updates to perform on a selected field in the selected 
items. 


4 Execute the change. 


You can perform the update on all selected items directly, or you can do it 
through a confirmation option on an item-by-item basis. 


If you are running in Installation mode, you are prompted to set up 
communication with Meridian 1 whenever you modify a data record. You can 
synchronize the data now, schedule a time for synchronization, or cancel the 
prompt and schedule synchronization later. See “Communicating with 
Meridian 1” on page 75. 
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Selecting Data Items 


In a data list window of Station Configuration or CPND Configuration, select 
the items you wish to update. You can change the current selection as follows: 


— Click to select a single item. 


— Use the Space bar to turn off all selections and select only the first station 
in the list. This method of selection turns off all other selections, leaving 
only the single current selection. 


— Toselect multiple stations, hold down the <Shift> key and click a station, 
or press the space bar, to toggle the selection status of that station without 
affecting other selections. If you hold down the shift key you can use the 
up/down arrow keys to add the next adjacent item to the highlighted list. 


You can use the Edit - Select All menu option to select all items, or you can 
define criteria to select a group of stations using the Edit - Select menu option. 
“Define Selection Criteria” on page 60 provides details on using the Select 
feature. 


Define Selection Criteria 


To define criteria for record selection, choose Edit - Select in the Station view 
of the Station Configuration window or in the CPND Configuration window. 
This displays a Record Selection Criteria dialog in which you enter the 
expression defining the selection criteria. 


Figure 19 
Record Selection Criteria dialog 
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An expression is a formula that follows standard mathematical conventions 
regarding the use of brackets ({ }) and the order of operations (add, subtract, 
multiply, or divide). Operations can act on numeric data or on field values 
from the MAT database. Field names must be exactly as defined in the MAT 
database. You can enter the desired expression by typing it in the text box 
directly, or by using the selection criteria and operation buttons provided. 


The dialog has buttons that allow you to select fields, operators, and functions 
to build a valid expression. You may have to modify the position of brackets 
when completing the expression. Use the following function buttons to insert 
a field or operator at the cursor position: 


Data Field: Available field names from the Station or CPND record as 
defined in “Station Data Manipulation” on page 21 or “CPND Data 
Manipulation” on page 47 (LastName, DN, or Location, for example). 


System Field: Available MAT system fields (Time or Date, for example). 
System fields are defined in “Select System Field” on page 62. 


Function: Functions operate on a field to generate a value that depends on 
the field value—Length, Minimum, Maximum, and so on. 


Operator: Arithmetic or Boolean operators—plus, divide, and OR, for 
example. 


When you have finished creating a valid expression, choose OK to display the 
Station configuration window—those items which fit the criteria are 
highlighted. You can still modify this selection as described in “Selecting 
Data Items” on page 60. 
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Select Data Field 


When you choose Data Field, a list of available fields is displayed in a Select 
Data Field dialog: 


Figure 20 
Select Data Field dialog 
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Select the desired station field name and choose OK to paste the field into the 
Select Criteria expression text box at the current cursor position. You can type 
a letter to scroll the listing to the next item starting with that letter. 


Select System Field 
When you choose System Field, a list of available fields is displayed in a 
Select System Field dialog. 


Figure 21 
Select System Field dialog 





Select System Field 





REC_COUNT 


WRAP_OVERFLOW 














Select the desired field name and choose OK to paste the selected field name 
into the Select Criteria expression text box at the current cursor position. 
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Select Function 

A function may generate a value on its own, or it may act on the field directly 
after it in the expression to produce a value that depends on that field value. 
When you choose Function, a list of available functions is displayed in a 
Select Function dialog. 


Figure 22 
Select Function dialog 


Select Function 


UPPER{(string) -> Convert to UPPER CASE 
LOWER(string) -> Convert to lower case 

TRIM(string) -> Trim Beginning and Ending Spaces Cancel 
WORD(string.num) -> Extract a Word from the String 
CHAR{(string.num) -> Extract a character from the String 
MIN(numi.num2) -> Find Smaller of two Numbers 


MAX[(num1.num2) -> Find Larger of two Numbers 
INT(num) -> Convert Float to Integer Number 
ROUND(num1 .num2) -> Round Num1 to Num2 Decimal 
-> Find Absolute Value 
-> Day of the week (string) 
-> Extract Day (nn) from a Date 
-> Extract Month (nn) from a Date 
-> Extract Year (nnnn) from a Date 














Select the desired field name and choose OK to paste the selected function 
name into the Select Criteria expression text box at the current cursor 
position. 
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Select Operator 

An operator causes a mathematical combination of field values (arithmetic, 
Boolean, conditional, and so on). When you choose Operator, a list of 
available operators is displayed in an Operators dialog. 


Figure 23 
Operators dialog 


Operators 


Cancel 











Select the desired operator and choose OK to paste it into the Select Criteria 
expression text box at the current cursor position. 


Selecting the Items for Change 

When you have completed the selection criteria expression, choose OK to 
return to the Configuration list window. All items that meet the defined 
criteria are highlighted. 


Example Expressions 


Below are examples of selection expressions to help you understand the 
SELECT feature. 


Example 1 


Select all stations that have been changed in the MAT database since the last 
Transmit to the switch. 
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The SYNCH field shows synchronization for the sets in relation to the switch 
database. If the synch status of the set is TRN (for transmitted) then all 
changes have been transmitted to the switch and the data is in synch with the 
switch. Any other status (NEW, OUT, CHG, RPL) identifies a set that has 
been changed on MAT and needs to be transmitted to the switch (see the Sync 
Status section on page 7 for details.) 


In order to select all stations that need to be transmitted, you can either select 
all stations in NEW, OUT, CHG or RPL status or you can simply select all 
sets that are not in TRN status. The selection will be the same in either case. 
For this example, we’ll choose all sets that are not in TRN status: 


Under EDIT choose SELECT 
a)From the Data Field list choose SSTAT 
b)Click <> (not equal to) from the Operator list (or simply type in <>) 


c)Type in “TRN” (Note: all strings must be enclosed in parenthesis. Column 
2 in the Data Field List identifies the field as either a string or numeric) 


The complete command in the Record Selection Criteria edit box will 
show: 


STATION->SSTAT<>”TRN” 


Note that instead of following steps a-c you may simply type in the 
expression above. 


d) Click 
All stations will be selected except those in TRN status. 


Example 2 
Select all stations with a prime DN between 4000 and 5000. 


To select all stations within this range, select all sets with PRIMEDN>4000 
and PRIMEDN<5000. MAT will allow you to do this by following these 
steps: 
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Under EDIT choose SELECT 


a 
b 


a oe 


e 
f 


Select PRIMEDN from the Data Field List 

Select> from the Operator list (or simply type in >) 
Type in “4000” 

From the Operator list select AND. 

Select PRIMEDN from the Data Field List 

Type in “5000” 


The complete command is: 


STATION->PRIMEDN>”4000”.AND.STATION->PRIMEDN<“5000” 


g 


Click OK 


All stations that have a prime DN between 4000 and 5000 will be selected. 


Example 3 


Select all M2616 sets with class of service CFXA. 


Under Edit choose Select 


a 
b 


Standard 4.00 


Select INST from the Data Field list 
Select = from the Operator list (or simply type it in) 


Type “M2616” (criteria is case sensitive; make sure you use a 
capital M) 


Select AND. from the Operator list 


Select CFXA from the Data Field List (the mnemonic CFXA 
represents Call Forward which can be either allowed “CFXA” or 
denied “CFD”’) 


Type in = “CFXA” 
Click OK 


May 1996 
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All M2616 type stations with Call Forward External Allowed (CFXA) will be 
selected. 


Specify the Change 
You can perform a global update on a single field in each item selected in the 
list window. Once you have selected the desired items for update, you select 
the field to change. 


Select the Field to Change 


When you choose Global Update from the Edit menu, the Select Data Field 
dialog list appears. The fields listed include only those that can be changed 
globally. For example, the Instrument (INST) field is not included in this list 
because some of the fields and their values in the record depend on the 
instrument. 


When you have selected the field to change, choose OK to display the Global 
Change Specification dialog. The selected field name is displayed in the 
Mnemonic box. The example below shows the entries required to change all 
selected station Departments to “Dept_X”, 


Figure 24 
Global Change Specification dialog 
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The Global Change Values edit list box lets you set up the changes in the field 
values of the field indicated by the Mnemonic box. The list box contains a list 
of changes that you define by entering values in the Old Value and New 
Value fields. 


Note: The Old and New Value text boxes are case-sensitive. The values 
must be entered in the same case as is used in the MAT database. For 
example, “Dept._ B” and “Dept._b” are not the same values. 


The following functions are available in the list box: 


— Add: Insert a new change, defined in the Old Value - New Value text 
boxes. In the example above, * (asterisk, the wildcard character) causes 
any Dept field value to be accepted, and the New Value—Dept_X—is 
added to the list of two items. 


— Update: Modify the selected change item as defined in the Old Value - 
New Value text boxes. In the example above, * and Dept_X replace the 
highlighted item. 


— Delete: Remove the selected change item from the list. 


To define a change: 


— Select the Old Value text box and enter the exact value of the data to be 
changed. 


— Select the New Value text box and enter the new value for the field. 
— Select Add to add this change to the list of changes for this field. 


You can repeat this Add function for any other values of the field that you 
wish to change. 


If you use an asterisk (*—the wildcard character) in the Old Value field, all 
records are updated to the New Value. 


You can decide whether to be prompted on a record-by-record basis or to 
perform the changes without confirmation by checking or clearing the 
Confirm Change check-box. 


When you have completed the required change list, choose OK to display the 
Global Change dialog. 
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Perform the Global Change 


When you select OK in the Global Change Specification dialog, the Global 
Change dialog appears. This dialog is a status dialog only—you cannot edit 
any of the fields. 


Figure 25 
Global Change Specification dialog 
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The dialog contains a Station definition area to identify the station currently 
being changed. The Change area displays the Old and New Values. 


If you are not using change confirmation, a “percentage done” bar informs 
you of the progress of the changes. 


While the change is in progress, the dialog displays the Cancel and Help 
buttons. Help displays help for this dialog and Cancel halts the change task. 


Note: If you use Cancel, there is no way of controlling which records 
are changed and which are not. 


When the task is complete, the Cancel button is replaced by an OK button. 
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Change Confirmation 


If you elected to confirm changes, a Confirmation dialog asks you whether to 
“Change this record?”, for each station record in turn. The Global Change 
dialog contains Station identification and Change identification data for the 
current field. 


Figure 26 
Confirmation dialog 


= Confirmation 


Change this record? 








You can move this dialog in the same way as other Windows dialogs in order 
to see the progress bar and function buttons in the Global Change box. 


The Confirmation dialog displays the following buttons: 


— Change: Perform the change indicated in the Global Change data box 
and proceed to the next station. 


— Skip: Proceed to the next station without changing the current one. 
— Change All: Proceed with all remaining changes without confirmation. 


— Cancel: Cancel all remaining changes. 


During the change process, the progress bar changes and the Global Change 
data area is updated. 


Change Completion 


When the Global Change task is complete, the Confirmation box is cleared, 
the Global Change box indicates 100% completion, and the Cancel button is 
replaced by an OK button. 


Choose OK in the Global Change dialog to return to the list window. 
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Global Update—Wildcards, Matching, and Allowed Fields 


In Edit/Global Update menu item, you build a list of changes for a single field 
on the selected records. The list of changes is built by Adding requests to 
change Old Value to New Value for the chosen field. To improve efficiency 
and to shorten the list of changes, you may use * (asterisk), the wildcard 
character. The wildcard matches any value in the field. 


Wildcard matches that you specify are always done after the other Old Value 
matches have failed. Otherwise, matches are attempted in order. For each 
selected record, the first change request that matches the Old Value is 
implemented. 


Key* allows you to update a feature when the key on which the feature resides 
is unknown. For example, suppose you wish to update the Conference key on 
all sets to No Hold Conference/Autodial. The Conference key may exist on 
any key of the selected station. Key* allows you to update the key feature 
without knowing the key number. MAT searches for the first occurrence of 
the feature specified, and updates that key per the instructions. See “Global 
Update—Examples” on page 72 for more detail. 


Certain fields on the station may not be changed with the Global update 
facility: 


— Location must be unique for each station, so Global update is not 
permitted. 


— Station type may not be changed with global update. 


— Certain administrative features of a station—including color and type 
cannot be changed. 
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Global Update—Examples 


A few examples are provided below to help you use the Select and Global 
Update features. These examples provide the basic steps for selecting stations 
based on certain criteria and updating common fields. These methods can be 
applied to a variety of Global Update situations. 


Example 1 


Suppose you wish to change all DNs in the range 4000-4999 to a 5 digit 
54000-54999. You wish to apply this change to all stations for Customer 1. 


1 


Global Update is applied to selected stations only. You should therefore 
select all stations for Customer 1. Use the Edit - Select menu item. Click 
on Data Field and choose the Customer Number field to build the 
expression STATION->CNUM = 1. (The STATION->CNUM portion is 
provided automatically when you select Customer Number from the list 
of Data Fields). 


If there is only one customer on the Meridian | system, you may instead 
use the Edit - Select All menu item to select all the stations for this DN 
change. 


Use the Edit/Global Update menu item to specify the DN change. 


a 


Specify the field to be changed in the Select Data Field dialog. MAT 
provides a special field called All Directory Numbers. You may 
move the highlight in the Select Data Field dialog until the All 
Directory Numbers field is highlighted. Click on OK to select the All 
Directory Number field. 


In the Global Change Specification, you are asked to build a list of 
each old value and the new value with which to replace it. The 
Mnemonic field shows that we are working with the field All 
Directory Numbers (ADN). 


Enter the DN range 4000-4999 in the Old Value box. Move to the 
New Value box and enter 54000-54999. To enable this change, click 
on Add. The requested change appears in the Global Change Values 
box. (You may Update or Delete each entry in the Global Values box 
by clicking the appropriate button.) 


When you are satisfied with this change request, click on OK. 
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c MAT examines each station to see if any changes need to be made. 
A meter marks MAT’s progress through the stations. The Cancel 
button halts the updating process. 


For any applicable station, the Global Change dialog displays 
identifying information for the station and the old and new values 
that are to be modified. 


Example 2 

Suppose you wish to change all Conference keys (A03) on all stations to No 
Hold Conference/Autodial keys (CA). Conference may currently be 
configured on any key on the selected stations. 


1 


Select the stations to be updated. Since all stations need to be changed, 
use the Select All feature in the Edit menu. 


Use the Edit - Global Update menu item to specify the desired change. 
Choose Key from the Select Data Field window. (You may move 
immediately to the Key mnemonic by typing in the first letter of the 
mnemonic, K.) The Global Update window appears. A list box allows 
you to specify which key to change. Since you are not sure which key on 
each station is equipped with Conference, use KEY*, the default for this 
list, to update the feature regardless of the key number. 


Enter the existing value of the Key to be changed in the Old Value box, 
A03 and TAB. (If the KEY you wish to change has parameters, tabbing 
brings up the parameter fields.) Conference does not have parameters, so 
tab moves you to the New Value box. Enter the Mnemonic of the new 
feature (in this case, CA for No Hold Conference Autodial). Press the 
<Tab> key to display edit boxes for the parameters associated with the 
new feature. Enter the appropriate data in the parameter fields. 


You may choose to confirm each change. Once you click on OK, MAT 
begins the updates. MAT searches each selected station for the first 
occurrence of A03. If A03 is encountered, MAT changes the Key to the 
new value: CA. Note that if the station contains multiple Conference 
keys, only the first will be changed. You can run a second global update 
to change the second appearance of a feature. 


Example 3 


Suppose you wish to add a feature to the first blank key on each set, but the 
first blank key may be a different key number on each set. 
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The choice of KEY * for your Global Update criteria will tell MAT to look for 
the first occurrence of a particular feature on each set selected. When MAT 
encounters that specified feature it will change that first occurrence to the 
specified new feature and then proceed to the next set. In the case of this 
example, the feature we are looking for is a blank feature. Perform the 
following steps: 


Select all the stations you wish to change 

Select EDIT-Global Update. 

Choose KEYGUPD (Key Global Update) from the criteria list 
Choose the KEY number KEY* (this is the default) 


an A WwW N me 


Enter nothing (blank) in the Old Value, enter the new feature mnemonic 
and appropriate parameters in the new value. Select Add to add to the 
Global Update list. 


6 Click OK. All Stations selected will have the new feature added to the 
first blank key. If a selected set does not have any blank keys, the feature 
will not be added to that particular set. 
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